Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components

Summary of Sequence Grabber Panel Components

C Summary

Constants

/* component type value */
#define  SeqGrabPanelType 'sgpn'    /* panel component type */

/* component manufacturer code values */
#define  SeqGrabCompressionPanelType   'sour'   /* input source selection */
#define  SeqGrabSourcePanelType        'cmpr'   /* compression settings */

/* componentFlags values for sequence grabber panel components */
enum {
   channelFlagDontOpenResFile = 2,  /* do not open resource file */
   channelFlagHasDependency   = 4   /* needs special hardware */
};

enum {
   /* sequence grabber panel request codes */
   kSGCPanelGetDitlSelect        = 0x200, /* SGPanelGetDITL */
   kSGCPanelCanRunSelect         = 0x202, /* SGPanelCanRun */
   kSGCPanelInstallSelect        = 0x203, /* SGPanelInstall */
   kSGCPanelEventSelect          = 0x204, /* SGPanelEvent */
   kSGCPanelItemSelect           = 0x205, /* SGPanelItem */
   kSGCPanelRemoveSelect         = 0x206, /* SGPanelRemove */
   kSGCPanelSetGrabberSelect     = 0x207, /* SGPanelSetGrabber */
   kSGCPanelSetResFileSelect     = 0x208, /* SGPanelSetResFile */
   kSGCPanelGetSettingsSelect    = 0x209, /* SGPanelGetSettings */
   kSGCPanelSetSettingsSelect    = 0x20A, /* SGPanelSetSettings */
   kSGCPanelValidateInputSelect  = 0x20B  /* SGPanelValidateInput */
};

Functions

Managing Your Panel Component

pascal ComponentResult SGPanelSetGrabber
(SeqGrabPanelComponent s, SeqGrabComponent sg);
pascal ComponentResult SGPanelCanRun
(SeqGrabPanelComponent s, SGChannel c);
pascal ComponentResult SGPanelSetResFile
(SeqGrabPanelComponent s, short resRef);
pascal ComponentResult SGPanelGetDITL
(SeqGrabPanelComponent s, Handle *ditl);
pascal ComponentResult SGPanelInstall
(SeqGrabPanelComponent s, SGChannel c, DialogPtr d, short itemOffset);
pascal ComponentResult SGPanelRemove
(SeqGrabPanelComponent s, SGChannel c, DialogPtr d, short itemOffset);

Processing Your Panel's Events

pascal ComponentResult SGPanelItem
(SeqGrabPanelComponent s, SGChannel c, DialogPtr d, short itemOffset, short itemNum);
pascal ComponentResult SGPanelEvent
(SeqGrabPanelComponent s, SGChannel c, DialogPtr d, short itemOffset, 
EventRecord *theEvent, short *itemHit, Boolean *handled);
pascal ComponentResult SGPanelValidateInput
(SeqGrabPanelComponent s, Boolean *ok);

Managing Your Panel's Settings

pascal ComponentResult SGPanelGetSettings
(SeqGrabPanelComponent s, SGChannel c, 
UserData *ud, long flags);
pascal ComponentResult SGPanelSetSettings
(SeqGrabPanelComponent s, SGChannel c, 
UserData ud, long flags);

Pascal Summary

Constants

CONST
   {component type value}
   SeqGrabPanelType                 = 'sgpn';   {panel component type}
   {component manufacturer code values}
   SeqGrabCompressionPanelType      = 'comp';   {compression settings}
   SeqGrabSourcePanelType           = 'sour';   {input source slection}
   {componentFlags values for sequence grabber panel components}
   channelFlagDontOpenResFile    = 2;  {do not open resource file}
   channelFlagHasDependency      = 4;  {channel has special hardware}
   {sequence grabber panel component request codes}
   kSGCPanelGetDitlSelect           = $200;  {SGCPanelGetDitl}
   kSGCPanelCanRunSelect            = $202;  {SGCPanelCanRun}
   kSGCPanelInstallSelect           = $203;  {SGCPanelInstall}
   kSGCPanelEventSelect             = $204;  {SGCPanelEvent}
   kSGCPanelItemSelect              = $205;  {SGCPanelItem}
   kSGCPanelRemoveSelect            = $206;  {SGCPanelRemove}
   kSGCPanelSetGrabberSelect        = $207;  {SGCPanelSetGrabber}
   kSGCPanelSetResFileSelect        = $208;  {SGCPanelSetResFile}
   kSGCPanelGetSettingsSelect       = $209;  {SGCPanelGetSettings}
   kSGCPanelSetSettingsSelect       = $20A;  {SGCPanelSetSettings}
   kSGCPanelValidateInputSelect     = $20B;  {SGCPanelValidateInput}

Routines

Managing Your Panel Component

FUNCTION SGPanelSetGrabber(s: SeqGrabComponent; sg: SeqGrabComponent): 
ComponentResult;
FUNCTION SGPanelCanRun(s: SeqGrabComponent; c: SGChannel): 
ComponentResult;
FUNCTION SGPanelSetResFile(s: SeqGrabComponent; resRef: Integer): 
ComponentResult;
FUNCTION SGPanelGetDITL(s: SeqGrabComponent; VAR ditl: Handle):
ComponentResult;
FUNCTION SGPanelInstall (s: SeqGrabComponent; c: SGChannel; 
d: DialogPtr; itemOffset: Integer): 
ComponentResult;
FUNCTION SGPanelRemove(s: SeqGrabComponent; c: SGChannel; 
d: DialogPtr; itemOffset: Integer): 
ComponentResult;

Processing Your Panel's Events

FUNCTION SGPanelItem(s: SeqGrabComponent; c: SGChannel; 
d: DialogPtr; itemOffset: Integer; 
itemNum: Integer): ComponentResult;
FUNCTION SGPanelEvent(s: SeqGrabComponent; c: SGChannel; 
d: DialogPtr; itemOffset: Integer; 
VAR theEvent: EventRecord; 
VAR itemHit: Integer; 
VAR handled: Boolean): ComponentResult;
FUNCTION SGPanelValidateInput
(s: SeqGrabComponent; VAR ok: Boolean): ComponentResult;

Managing Your Panel's Settings

FUNCTION SGPanelGetSettings(s: SeqGrabComponent; c: SGChannel; 
VAR ud: UserData; flags: LongInt): 
ComponentResult;
FUNCTION SGPanelSetSettings(s: SeqGrabComponent; c: SGChannel; 
ud: UserData; flags: LongInt): ComponentResult;

Result Codes

noDeviceForChannel	-9408	Cannot work with specified channel
badComponentSelector	0x80008002	Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help